<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<!-- Content Stylesheet for Site -->

        
<!-- start the processing -->
    <!-- ====================================================================== -->
    <!-- Main Page Section -->
    <!-- ====================================================================== -->
    <html>
        <head>
            <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>

                                                    <meta name="author" value="Cort Schaefer">
            <meta name="email" value="cort@xmission.com">
            
           
                                    
            <title>NVelocity - NVelocity</title>
	    <link rel="SHORTCUT ICON" href="..//images/favicon.ico">
	    <link rel="stylesheet" type="text/css" href="..//css/nvelocity.css">

<link rel="stylesheet" type="text/css" href="..//css/nant-task.css">
        </head>

        <body bgcolor="#ffffff" text="#000000" link="#525D76">        
	<table border="0" width="100%" cellspacing="0" ID="Table2">
	    <tr>
		<td align="left">
		    <A href="http://sourceforge.net"><IMG src="http://sourceforge.net/sflogo.php?group_id=58632&amp;type=5" width="210" height="62" border="0" alt="SourceForge Logo"></A>
		</td>
		<td align="right">
		    <a href="http://nvelocity.sourceforge.net" style="text-decoration: none;">
			<span class="title">NVelocity</span></a>
		</td>
	    </tr>
	</table>
	<br>


            <table border="0" width="100%" cellspacing="4">
                <tr><td colspan="2">
                    <hr noshade="" size="1"/>
                </td></tr>
                
                <tr>
                    <!-- LEFT SIDE NAVIGATION -->
                    <td width="20%" valign="top" nowrap="true">
                                <p><strong>About</strong></p>
        <ul>
                    <li>    <a href="../index.html">Overview</a>
</li>
                    <li>    <a href="http://sourceforge.net/project/showfiles.php?group_id=58632">Download</a>
</li>
                    <li>    <a href="../changelog.html">ChangeLog</a>
</li>
                </ul>
            <p><strong>Community</strong></p>
        <ul>
                    <li>    <a href="http://sourceforge.net/projects/nvelocity">Project Summary</a>
</li>
                    <li>    <a href="http://sourceforge.net/mail/?group_id=58632">Mailing Lists</a>
</li>
                    <li>    <a href="http://sourceforge.net/cvs/?group_id=58632">CVS Repositories</a>
</li>
                </ul>
            <p><strong>Docs</strong></p>
        <ul>
                    <li>    <a href="../api/overview-summary.html">API Specs</a>
</li>
                    <li>    <a href="../nant/index.html">NAnt Tasks</a>
</li>
                    <li>    <a href="http://jakarta.apache.org/velocity/vtl-reference-guide.html">VTL Reference Guide</a>
</li>
                </ul>
            <p><strong>Related Sites</strong></p>
        <ul>
                    <li>    <a href="http://jakarta.apache.org/velocity">Velocity (the original)</a>
</li>
                    <li>    <a href="http://sourceforge.net/projects/mavnet">Maverick.Net</a>
</li>
                    <li>    <a href="http://sourceforge.net/projects/nant">NAnt</a>
</li>
                </ul>
                        </td>
                    <td width="80%" align="left" valign="top">
                        <h1>dvsl</h1>
    <p><p>Processes a set of XML documents using a stylesheet written in DVSL (Declarative Velocity Style Language).</p><p>This is useful for building views of XML based documentation, or for generating code, etc. Conceptually, this task performs the same function 
	as the &lt;style&gt; task included with the Ant distribution but using a stylesheet with DVSL syntax instead of XSLT. </p></p>
    <h3>Parameters</h3>
    <div class="Table-Section">
      <table class="Table">
        <tr>
          <th class="Table-Header">Attribute</th>
          <th class="Table-Header">Description</th>
          <th class="Table-Header" align="left">Required</th>
        </tr>
        <tr>
          <td class="Table-Cell" valign="top" align=left>destdir</td>
          <td class="Table-Cell" align=left>Directory in which to store the results.</td>
          <td class="Table-Cell" align=left>true</td>
        </tr>
        <tr>
          <td class="Table-Cell" valign="top" align=left>extension</td>
          <td class="Table-Cell" align=left>This is the extension that is appended to the end of your .xml file. For example, with an extension of ".html", index.xml would be converted into index.html. By default, the extension is .html.</td>
          <td class="Table-Cell" align=left>false</td>
        </tr>
        <tr>
          <td class="Table-Cell" valign="top" align=left>style</td>
          <td class="Table-Cell" align=left>This is the path to the .vsl template</td>
          <td class="Table-Cell" align=left>true</td>
        </tr>
        <tr>
          <td class="Table-Cell" valign="top" align=left>force</td>
          <td class="Table-Cell" align=left>Recreate target files, even if they are newer than their corresponding source files or the stylesheet.</td>
          <td class="Table-Cell" align=left>false</td>
        </tr>
        <tr>
          <td class="Table-Cell" valign="top" align=left>outputencoding</td>
          <td class="Table-Cell" align=left>encoding to be used for output files. If not specified, the default is UTF-8</td>
          <td class="Table-Cell" align=left>false</td>
        </tr>
        <tr>
          <td class="Table-Cell" valign="top" align=left>logfile</td>
          <td class="Table-Cell" align=left>log file for Velocity messages. The default is to log through Ant's logging system but limit output based on Ant's logging level. Specifying this attribute causes all Velocity messages to be sent to the specified file instead.</td>
          <td class="Table-Cell" align=left>false</td>
        </tr>
        <tr>
          <td class="Table-Cell" valign="top" align=left>toolboxfile</td>
          <td class="Table-Cell" align=left>specifies the toolbox properties file name.</td>
          <td class="Table-Cell" align=left>false</td>
        </tr>
        <tr>
          <td class="Table-Cell" valign="top" align=left>validatingparser</td>
          <td class="Table-Cell" align=left>specifies that the parser for the input XML should validate. Boolean valued, default is false.</td>
          <td class="Table-Cell" align=left>false</td>
        </tr>
      </table>
    </div>

    <h3>Context Objects</h3>
    <div class="Table-Section">
      <table class="Table">
        <tr>
          <th class="Table-Header">Name</th>
          <th class="Table-Header">Description</th>
        </tr>
        <tr>
          <td class="Table-Cell" valign="top" align=left>$context.GetAppValue($String)</td>
          <td class="Table-Cell" align=left>Used to expose application specific values, including "infilename" and "outfilename" which represent file names without path for the input and output files.</td>
        </tr>
      </table>
    </div>


    <h3>Examples</h3>
    <p class="i1">This is the task definition to create the NVelocity site documentation</p><pre class="code">
&lt;dvsl style="xdocs/example1.dvsl"
      destdir="output"
      extention=".html"
      force="false"
      logfile="dvsl.log"&gt;
	&lt;fileset basedir="xdocs"&gt;
                &lt;includes name="*.xml"/&gt;
	&lt;/fileset&gt;
&lt;/dvsl&gt;
 </pre>
                    </td>
                </tr>

                <!-- FOOTER -->
                <tr><td colspan="2">
                    <hr noshade="" size="1"/>
                </td></tr>
                <tr><td colspan="2">
                    <div align="center"><font color="#525D76" size="-1">
		    <!-- <em>Copyright &#169; 2002, Cort Schaefer</em> -->
		    </font>
		    </div>
                </td></tr>
            </table>
        </body>
    </html>

<!-- end the processing -->





















